home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3.2 / Ham Radio Version 3.2 (Chestnut CD-ROMs)(1993).ISO / rtty / trty / trty.doc < prev    next >
Text File  |  1988-05-03  |  37KB  |  847 lines
  1.  
  2.                         T R T Y   3 0 0 0 . 00
  3.  
  4.                for ZENITH Z-100 and IBM COMPUTER SYSTEMS
  5.                                                   
  6.                          BY SKYLINE ASSOCIATES 
  7.  
  8.                              MAY 1st, 1988     
  9.       
  10.      The  TRTY.EXE  program  is  a  split-screen,  dual-port  communication
  11.   control program, developed as a result of many  years  of  Amateur  Radio
  12.   Teletype  operational  experience  on  the Heath Computer Radio Net. Many
  13.   Amateur Radio Operators contributed to the  specifications  for  and  the
  14.   implementation  of  this  program, and to all of them, SKYLINE ASSOCIATES
  15.   gives THANKS.
  16.  
  17.  
  18.                               -:LICENSE:-                           
  19.       
  20.      This  version  of  TRTY  is  NOT  public domain software, but is being
  21.   distributed as "shareware" and for now,  "FREE  OF  CHARGE",  except  for
  22.   specific requests for a copy of the program.
  23.  
  24.      Operators of electronic bulletin board systems (Sysops) are encouraged
  25.   to  post TRTY.EXE for down loading by their users, as long as the program
  26.   is not modified, and this document (TRTY.DOC) the help  file  (TRTY.HLP)
  27.   and  the MASTER.DOC, is included with the program. All of these files are
  28.   included in the TRTY.ARC file.
  29.  
  30.      If  bugs  or improvements are reported, an updated disk containing the
  31.   latest version TRTY.EXE program, and document file will returned  to  the
  32.   reporter, if the bug or improvement results in a new version of TRTY.EXE.
  33.   For  a  handling charge of $10.00, a disk with the program and doc files,
  34.   is available.
  35.  
  36.   Send your letters, or requests to:
  37.       
  38.        T.L.Vinson
  39.          RR1, Box 175
  40.          Pine Island, MN 55963
  41.          507-356-8513
  42.  
  43.                               -:DISCLAIMER:-                          
  44.       
  45.      Use  of  this  program acknowledges this disclaimer of warranty: "This
  46.   program is supplied as-is. SKYLINE ASSOCIATES disclaims  all  warranties,
  47.   expressed  or  implied,  including, without limitation, the warranties of
  48.   merchantability and of fitness of this program for any  purpose.  SKYLINE
  49.   ASSOCIATES  assumes  no  liability  for  damages direct or consequential,
  50.   which may result from the use of this program."
  51.       
  52.                                -:TRADEMARKS:-
  53.       
  54.    Z100 and ZENITH are registered trademarks of ZENITH Corporation.
  55.    IBM is a registered trademark of IBM Corporation.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                 2. TRTY            
  69.  
  70.   Features of TRTY.EXE 3000.00:---
  71.  
  72.   Supports two serial ports simultaneously, in half or full duplex.
  73.  
  74.   Supports BAUDOT, with 4 levels, and 7 or 8 bit ASCII. Baud rates from
  75.        45 to 9600.
  76.  
  77.   Software and Hardware handshaking.
  78.  
  79.   Colors may be set for all text and window borders.
  80.  
  81.   Configuration files may be set up and recalled by name.
  82.  
  83.   Separate Radio call signs for each session.
  84.  
  85.   Beep on recognition of call sign.
  86.  
  87.   Window edges or borders may be changed to suit.
  88.  
  89.   Full screen editing with windows.
  90.  
  91.       Operator  may  scroll  through  text  previously shown but rolled off     
  92.       the screen.       
  93.  
  94.       Operator  may  edit text in one window while monitoring one or both 
  95.       ports in other windows.
  96.  
  97.   Same  program runs on IBM PC or ZENITH Z100, and Z100 with the ZPC IBM
  98.       emulator.
  99.  
  100.  
  101.                         -:TRTY PROGRAM OVERVIEW:- 
  102.  
  103.      The TRTY.EXE program will function with either a ZENITH Z100 or an IBM
  104.   PC  computer.  A  command line indicator is used to assist in this system
  105.   recognition. The program will also work with the  ZPC  emulator,  on  the
  106.   ZENITH  Z100.  A  color  monitor  is desirable, but not necessary for the
  107.   program.
  108.  
  109.      Each  serial port on an IBM or Zenith Z100 system is controlled from a
  110.   SESSION split-screen. SESSION 1 controls Port Com1 or Port A, and SESSION
  111.   2 controls Port Com2 or Port A, as the case maybe. Each  SESSION  can  be
  112.   configured  for Baud rate, Baudot or ASCII, half or full duplex, and many
  113.   other configurable items,  to  tailor  the  program  to  your  needs  and
  114.   communication  system.  Each  SESSION  screen  consists of two windows, a
  115.   DIALOG window to show incoming data, and a PRETYPE window, to buffer  the
  116.   outgoing data. These windows can be configured to overlay, or appear side
  117.   by side, or stacked , in a three or four window display called DUAL mode.
  118.   More on DUAL mode, later.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                                  3. TRTY
  135.  
  136.                        -:CONFIGURING THE PROGRAM:- 
  137.  
  138.      All   of   the   operator  and  system  interfaces  can/may/should  be
  139.   configured. This configuration  task  is  not  difficult,  so  let's  get
  140.   started and learn at the same time.
  141.  
  142.      Type  out  this  document  file,  TRTY.DOC,  and  the TRTY.HLP file to
  143.   facilitate the first use of the program.  The  MASTER.DOC,  is  a  master
  144.   configuration  file,  and  shows  all of the configuration possibilities,
  145.   with comments. Printing this  will  also  be  of  help  in  learning  and
  146.   understanding this program.
  147.  
  148.      It is important to note that the editing of the HELP and CONFIGURATION
  149.   screen,  changes  the  screen,  but does not change the files or the TRTY
  150.   program. These two files must be SAVED, after editing, and installed,  if
  151.   you  want  to  implement  the changes. The remainder of the configuration
  152.   menus are actually changing the TRTY program variables, and these changes
  153.   must be saved in the TRTY.CFG file, (pushing F4) to  become  a  permanent
  154.   part  of the configuration file. I will point out this requirement, as we
  155.   progress through the configuration menus. Nothing you can do will  change
  156.   the  TRTY.EXE  file  that  exits  on  the  default  device.  A  messed up
  157.   configuration file can be deleted, and a new start made, at any time.
  158.  
  159.      The  program can be configured completely by editing the CONFIGURATION
  160.   file, but unless you are familiar with the  program,  a  more  successful
  161.   configuration will result by starting at the bottom of the MAIN menu, and
  162.   working up.
  163.  
  164.      One point of information, to exit the program for any reason hit CTRL-
  165.   C or ESC twice, and the program will close all files, return the ports to
  166.   their original initialization and exit to the operating system. 
  167.  
  168.      First, call the file TRTY.EXE with a COMMAND LINE addition of the type
  169.   of  machine  being  used.  TRTY  alone,  will  also  work, but some 'WILD
  170.   INTERRUPTS' will flash on the  screen,  as  the  program  determines  the
  171.   machine type. Under some conditions, 'WILD INTERRUPTS' will flash because
  172.   Turbo  C  also  checks for an IBM system. The configuration of the program
  173.   will be the default configuration from within the program.  If  the  file
  174.   TRTY.CFG exists on the drive, that will be used to configure the program.
  175.  
  176.     TRTY ZEN <cr> (forces Z-100 ports and screen)
  177.     TRTY ZPC <cr> (forces Z-100 ports and IBM screen, using ZPC with Z-100)
  178.     TRTY IBM <cr> (forces IBM ports and IBM screen for IBM or IBM ports 
  179.                     and IBM screen for the Z100 when using ZPC emulator.)
  180.  
  181.      The  first  screen  visible  will be the LOGO of the TRTY.EXE program.
  182.   This LOGO can be bypassed, by so configuring the program. Hit any key, to
  183.   proceed to the operation screen. For this first configuration discussion,
  184.   I will assume that there was no TRTY.CFG file on the default drive.
  185.  
  186.      The  second  screen  will  be the SESSION 1 split screen, with borders
  187.   around the upper or DIALOG screen, and the lower PRETYPE1 screen. At  the
  188.   bottom  of  the screen, on the 24th and 25th lines will be the following:
  189.  
  190.    ________________________________________________________________________       
  191.    | SESSION 1 Baud Rate 45.5 Bit Mode Baudot Log None Port is Off x08:00 |
  192.    |  F1=Setup  1995  Available  Buffers  0  Lines  1  1  gggg  Pretype 1 | 
  193.    |______________________________________________________________________|         
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                  4. TRTY
  201.  
  202.   SESSION 1 means, this screen is for control of PORT A, or Com 1.
  203.           PUSH F10 and the second screen, SESSION 2, will appear. Push F9.
  204.  
  205.   Baud Rate 45.5 is the default baud rate.
  206.  
  207.   Baudot means 5 bit Baudot code. 
  208.  
  209.   Log None means that the logging function has not been set.
  210.  
  211.   Port is Off means the Port is not active.
  212.  
  213.   x08:00 is the time of day, the 'x' appears when using XON/XOFF hand-
  214.          shaking, and an XOFF has been received. More later.
  215.          
  216.   On the 25th line:
  217.  
  218.   F1=Setup means, Push F1 to get the SetUp Menu.
  219.  
  220.   1995 Available Buffers means, number of line buffers available.
  221.        The number of buffers depends on the amount of RAM available.
  222.        The maximum buffers set will be 2000. (80 char lines)
  223.  
  224.   0 Lines means, number of lines in the buffer with the active cursor.
  225.  
  226.   1  1  means, line number and character number of the active cursor.
  227.  
  228.   gggg  Shows a GIMMIC when data is incoming, or outgoing, for each SESSION.
  229.          A flashing cross for incoming, and a musical note for outgoing.
  230.  
  231.   Pretype1 indicates where the active cursor is located. Hit F2 to put 
  232.        active cursor into Upper or DIALOG 1 window. Push F2 again, and
  233.        return cursor to PRETYPE 1 window.
  234.  
  235.   Push F1 to view the available menus.
  236.  
  237.                           -:MAIN MENU:-
  238.                 ____________________________________________
  239.                 |                                 Main     |
  240.                 |   1.  Help.                  (Shift-F1)  |
  241.                 |   2.  Configure.             (Shift-F2)  |
  242.                 |   3.  Disk I/O.              (Shift-F3)  |
  243.                 |   4.  Window Management.     (Shift-F4)  |
  244.                 |   5.  Miscellaneous Options. (Shift-F5)  |
  245.                 |   6.  Port Setup.            (Shift-F6)  |
  246.                 |   7.  Show file usage.       (Shift-F7)  |
  247.                 |   8.  Change constants       (Shift-F8)  |
  248.                 |                                          |
  249.                 |       Select a function from this list.  |
  250.                 |__________________________________________|
  251.  
  252.      This  is  the Main Menu, and is the starting point to configure all of
  253.   the interface items and conditions.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                                  5. TRTY
  267.  
  268.      Pushing  the number keys, 1-8 will bring up the appropriate menus. The
  269.   right hand listing of Shift-f keys, are the  commands  from  the  SESSION
  270.   screens, to go directly to the a specific menu, bypassing the MAIN menu.
  271.  
  272.      Keep   in   mind   the   differences  between  editing  the  HELP  and
  273.   CONFIGURATION files, and editing the other direct operating menu  items,
  274.   proceed with the configuration. Let's start, assuming little knowledge of
  275.   the program and in a way that will enhance your learning process.
  276.  
  277.                          -:CHANGE CONSTANTS MENU:-  
  278.  
  279.      Assuming  that  the  MAIN  menu  is  showing,  PUSH  number 8, 'CHANGE
  280.   CONSTANTS', and set up the items  on  that  menu.  After  completing  the
  281.   editing,  PUSH F4 to bring up the 'WRITE FILE' menu. The default fname is
  282.   'TRTY.CFG', but any fname.cfg may be used, or the  configuration  may  be
  283.   saved  in  each of several files. If 'TRTY.CFG' as a fname is appropriate
  284.   hit <cr>, and the file will be saved.
  285.  
  286.   END OF LINE SEQUENCES:-
  287.  
  288.      This  controls  the  sequence sent whenever a new line is started from
  289.   the transmitted text. It is triggered by the RETURN key,  automatic  wrap
  290.   of  a  line  being entered into the buffer, or by a NEWLINE (0AH, same as
  291.   LINE FEED) character from a  disk  input  file.  Baudot  allows  CARRIAGE
  292.   RETURN  (C),  LINE  FEED  (N),  LETTERS (L), or FIGURES (F). ASCII allows
  293.   CARRIAGE RETURN (C) and LINE FEED (N). ASCII mode  will  ignore any other
  294.   end of line characters. If left blank, the default sequence is CCL.
  295.  
  296.      Hit F1 after the operating screen returns, to again bring up the MAIN
  297.   menu.
  298.  
  299.      Ignore  item  7  for  now,  I  will  return  to  it later. It is not a
  300.   configuration item, but the menu to view file status for the program.
  301.  
  302.      Continue  through  menus number 6 and then 5. If you wish to configure
  303.   both SESSIONS, to use both ports, configure SESSION 1 and then push  F10,
  304.   and configure SESSION 2. You will see the SESSION number being configured
  305.   at  the  lower  left  of  the  screen.  If  you  wish to configure for an
  306.   alternate port baud rate, for each  SESSION,  push  F3,  and  program  an
  307.   alternate  setup,  using the same items in the menu. The program has this
  308.   capability, maintaining an alternate setup for each port, callable by F3.
  309.   Make sure that the setup you desire  for  the  normal  start  up  of  the
  310.   program, is showing on the 24th line prior to saving the setup.
  311.  
  312.                            -:SET PORT MENU:-
  313.  
  314.      When  items  are selected in the PORT menu, the 24th line will change,
  315.   indicating the  a  new  configuration.  Setting  the  DIALOG  mode,  will
  316.   activate  the  PORT.  Proceed  with the next item, as soon as the desired
  317.   configuration is reached. No port assignment is available, as  the  ports
  318.   are  permanently  set to each SESSION. If you are configuring the program
  319.   for DUAL-PORT, configure SESSION1  port,  then  hit  F10,  and  configure
  320.   SESSION2.  Note  the  SESSION  being configured will be shown on the 25th
  321.   line. F9 and F10 will toggle between sessions. Switching sessions may  be
  322.   done at any time, and only one F4, 'Save Configuration' will be needed.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                                  6. TRTY
  333.  
  334.      When  the  'Change  Log Option' is first configured, a WRITE FILE menu
  335.   will appear. No fname will be shown. Hitting <cr> will  force  a  default
  336.   fname  consisting  of  MONth,  DAy  and  Session number (MAR12S2) with an
  337.   extension of .001. If you insert a fname of your choice, do  not  use  an
  338.   ext, as the program will assign .001, and increment that as new files are
  339.   created.  The  default  LOGNAME shown in the configuration record will be
  340.   "*", which is shorthand for the MONth-DAy-Session fname. Any other  fname
  341.   will  be shown as configured. The size of the log file is set directly by
  342.   editing the CONFIGURATION file, and is set by default at 5000 characters.
  343.  
  344.       The Dialog Mode should be set to 'Receiving' for half-duplex BAUDOT
  345.   or ASCII communications. For Full-Duplex, set the mode to Full-Duplex.
  346.  
  347.       The Connection Type should be set to 'blank', or to 'Relay'.
  348.  
  349.       Set the 'Stop Bits' to 1.5 for BAUDOT, and to 1 for normal ASCII and
  350.   FULLDUPLEX operation. Stop bits can be set for 1, 1.5 and 2. 
  351.  
  352.   Save the port setup/s by pushing F4. 
  353.  
  354.                       -:MISCELLANEOUS OPTIONS MENU:-
  355.  
  356.      Bring  up  the  MAIN  menu,  hit  the number 5, for the 'MISCELLANEOUS
  357.   OPTIONS' menu.
  358.  
  359.      Some of the "MISCELLANEOUS OPTIONS' can be configured for each SESSION
  360.   and  some are items applicable to both SESSIONS. Switch SESSIONS, if both
  361.   are being configured, and save with F4.  Always  return  to  the  SESSION
  362.   screen  that  you  wish  to  be  the default or start up screen, prior to
  363.   saving the configuration  because  the  start  SESSION  is  part  of  the
  364.   configuration record.
  365.  
  366.   3RD AND 4TH LEVEL OPERATION:-
  367.  
  368.      One  of  the  features  of  this  program is called "3rd and 4th level
  369.   BAUDOT". This is a programming method of sending and receiving  the  full
  370.   ASCII  character set over a BAUDOT channel. This program always transmits
  371.   with 3rd and 4th level characters, and is always available. 
  372.  
  373.      Unlock  the  "CAPS  LOCK", to send lower case data. The print on a TTY
  374.   machine, or on a CRT (with other than this program), will show as  if  it
  375.   were  normal Baudot. Of course, normal ASCII at 100 WPM can also be used,
  376.   if desired.
  377.  
  378.      3rd  and 4th level 'receive' is set as a configuration item and may be
  379.   set on or off for each session.
  380.  
  381.   BREAK MODE:-
  382.  
  383.       Setting item 2 to 'Y', shortens  the startup 'DIDDLES' and changes
  384.   the CTRL-G, for end of transmission to '-BK-' for fast break-in.
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                                   7. TRTY
  399.  
  400.   RELAY:-
  401.  
  402.      The  RELAY  mode  is set by this menu, and is the mode to allow remote
  403.   stations to relay messages through your station, automatically, from  the
  404.   originating  station.  In  the  "RELAY" mode, there is a timer to prevent
  405.   untransmitted relay messages to linger in the Pre-type buffer. This timer
  406.   can be set up to one hour long, which prohibits any relay message  longer
  407.   than 1/2 the set time. If the timer expires, the relay message is cleared
  408.   and  the  relay function is armed for another usage. The default time out
  409.   is 3600 seconds, one hour, which may  be  changed  in  the  configuration
  410.   record.  A time less than 1200 seconds (twenty minutes total) is near the
  411.   lower limit for practical use of the relay function.
  412.  
  413.   NOTE: To use the relay system, follow these steps:
  414.  
  415.   1. Send call of station having a RTY or TRTY program operational with the
  416.   capital characters ZC, appended to the call of the relay station.
  417.  
  418.         callsignZC <ret> (puts relay station into RELAY MODE)
  419.         callsignZC <ret> (send a second time to assure reception)
  420.  
  421.     2. Send normal message to station: "W0NW de W0SE etc."
  422.  
  423.     3. Send <ret> then "four N's" and a <ret>.
  424.  
  425.     4. Send call of station being used for relay, with ZR
  426.  
  427.            callsignZR (tells relay station to relay)
  428.  
  429.     5. Hit CTRL-V to leave the air immediately
  430.  
  431.     6. Watch relay being made.
  432.  
  433.   WRU on CALLSIGN:-
  434.  
  435.      If  this  item  is  set  to  "Y" in the configuration screen, for each
  436.   session, the WRU will not respond to the :DISK of :TIME command, but only
  437.   to callsignZW.
  438.  
  439.   FANCY MARGIN:-
  440.  
  441.      Setting  item  5  to  'Y' means, send FANCY MARGIN at the beginning of
  442.   each AUTOWRAPed line, as configured in the CONFIGURATION file.
  443.  
  444.   PIX:-
  445.  
  446.      In the "PIX MODE", the "UNSHIFT ON SPACE" is disabled. The shift stays
  447.   the  same  as  it  was  before the space. A <CR> does not line feed. When
  448.   sending long  PIX  files,  a  pause  will  be  initiated  at  ten  minute
  449.   intervals,  asking  if  a  'station identification line should be sent?'.
  450.   This can be bypassed by suitable response to the query.
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.                                    8. TRTY
  463.   DUAL SCREENS:-
  464.  
  465.      One  item  called  'DUAL' in the 'MISCELLANEOUS OPTIONS' menu requires
  466.   special explanation.  This  item  makes  possible  the  viewing  of  both
  467.   SESSIONS  on  a  split  screen of either three windows, or four. The DUAL
  468.   windows may be configured as three windows, with two dialog windows,  and
  469.   the  PRETYPE  windows  overlayed, or as four windows, with the DIALOG and
  470.   PRETYPE windows in each quadrant of the screen, or four windows from  top
  471.   to bottom of the screen. Then setting of 'DUAL=3", will allow the PRETYPE
  472.   windows  to  be  overlayed,  and  activity on one PRETYPE window will not
  473.   bleed through to the overlayed window. A setting of  'DUAL=4'  will  make
  474.   the PRETYPE windows transparent, and activity in either window will show.
  475.   The  placement and size of the windows is done in the 'WINDOW MANAGEMENT'
  476.   menu.
  477.  
  478.   SCREEN SAVER:-
  479.  
  480.      Set  item  to 'Y' to blank the screen, after 10 minutes of no input to
  481.   any window. Hit any key to refresh the screen.
  482.  
  483.   PRINTER:-
  484.  
  485.      The printer may be programmed to print only one of the two sessions.
  486.   If the printer has been programmed and not made ready, the program will
  487.   hang up, not indicating what the problem is, when printing is called.
  488.  
  489.                       -:WINDOW MANAGEMENT MENU:-
  490.  
  491.      Call up the 'WINDOW MANAGEMENT' menu from the MAIN menu, and configure
  492.   the  window  placement  by  selecting  the appropriate window, moving the
  493.   borders with the ARROW KEYS, and then save the configuration  by  hitting
  494.   F4.  The number and placement of the windows should be in accordance with
  495.   the previous setting for DUAL.
  496.  
  497.                           -:DISK I/O MENU:-
  498.  
  499.      Item  3  in  the MAIN menu, is used to READ, WRITE files and to view a
  500.   directory. Experiment with this item after finishing the configuration of
  501.   the program.
  502.  
  503.                          -:CONFIGURATION MENU:
  504.                 ___________________________________________
  505.                 |                          Configure      |
  506.                 | 1. Edit Configuration File.             |
  507.                 | 2. Read Configuration File.             |
  508.                 | 3. Write Configuration File.            |
  509.                 |                                         |
  510.                 | 4. Reconfigure Keys.                    |
  511.                 | 5. Toggle Sample Colors.                |
  512.                 |                                         |
  513.                 | F2 Install and Run Configuration.       |
  514.                 |                                         |
  515.                 | F4 Create Configuration File from       |
  516.                 |    Installed Configuration.             |
  517.                 |_________________________________________|
  518.  
  519.      The  first  time  you try this, without a TRTY.CFG file on the default
  520.   drive, the program default configuration will be shown. If TRTY.CFG exits
  521.   on the drive, that will be shown. If fname.CFG file has been called  from
  522.   the  COMMAND line, that will be shown. Keep in mind the need to both save
  523.   an edited configuration file, and to install  it  into  the  program,  as
  524.   mentioned earlier.
  525.  
  526.  
  527.  
  528.                                 9. TRTY
  529.                        
  530.      To write an edited configuration file, hit number key 3. In each case,
  531.   the  WRITE  file MENU will appear, as before. The normal fname written by
  532.   the program is TRTY.CFG. Either hit <cr> or  change  the  fname  and  hit
  533.   <cr>.   Now   hit  the  F1  and  key  number  1,  and  view  the  default
  534.   configuration, or edited file.
  535.  
  536.   COLORS:-
  537.  
  538.      The  colors,  or intensity levels on a monochrome screen, are shown on
  539.   the bottom of the screen, when the  CONFIGURATION  file  is  called.  All
  540.   color  numbers  are  possible,  space  precludes  showing all colors. Try
  541.   numbers that fall between the numbers shown. An EGA screen  can  be  very
  542.   colorful.  To  change  the  colors of the text and borders of any window,
  543.   edit the configuration record directly, adding  the  color  keywords  and
  544.   numbers   to   each  window  section.  Each  window  must  be  configured
  545.   separately. The colors for the 24th and 25th lines, and  the  colors  for
  546.   the menus, are called out at the top of the comfiguration record, and can
  547.   be  changed from the default colors by editing these lines of the record,
  548.   changing only the color numbers.
  549.  
  550.   FOREGROUND n        /*Color of the normal text, and GIMIC on 25th line.
  551.   HIGH_LITER n        /*Color for 'BLOCK' identification.
  552.   BORDER n            /*Color for border of window.
  553.   MOVE_BORDER n       /*Color for border when being moved in WINDOW menu.
  554.  
  555.      The  colors  for the 24th and 25th lines are part of the configuration
  556.   record, and may be changed only by editing those lines in the file.
  557.  
  558.   DVORAK KEYBOARD ANYONE? or RECONFIGURING THE KEYBOARD:-
  559.  
  560.      Each  key or key combination can be remapped by hitting number 4, from
  561.   the CONFIGURATION menu. If you would like to exchange  the  functions  of
  562.   the  key  combinations  CTRL-W  and CTRL-U, (WRU sent with the CTRL-U, in
  563.   place of CTRL-W and 'unmark the MARKED BLOCK sent by CTRL-W), call up the
  564.   RECONFIGURE  KEY  menu.  As  requested  by  the  menu,  hit  the   CTRL-U
  565.   combination, as the key combination to be remapped, and at the next menu,
  566.   hit  the CTRL-W combination. Both the CTRL-W and CTRL-U will now send the
  567.   WRU, so go back to the RECONFIGURE KEYS menu, and hit CTRL-W at the first
  568.   menu, and CTRL-U at the second menu. The configuration  is  now  reversed
  569.   for the two keys, and has replaced the default mapping in the program. Be
  570.   sure  to  save the file by hitting F4, to make the exchange a part of the
  571.   configuration file. Install the change by hitting  F2.  Any  letter  key,
  572.   number key, or control combination can be remapped with this feature. The
  573.   sequence  of  keys  is important, first the key to be remapped , and then
  574.   the  function  to  be  redirected,  then  F4  to   save   the   installed
  575.   configuration.  Make  sure  you redirect both keys, control sequences, or
  576.   there will two keys doing or printing the same thing.
  577.  
  578.                               -:HELP MENU:-
  579.  
  580.      The  remaining configuration menu is the HELP menu. Hit number 1, from
  581.   the MAIN menu, the HELP MENU will appear, if the TRTY.HLP file is on  the
  582.   default  drive. This file may be edited/written either from this menu, or
  583.   by use of any editor. The format of the Help file is not fixed,  and  can
  584.   be  customized  as  desired.  If  any  the  Keyboard Keys are redirected,
  585.   changes to the HELP file should be made to indicate the latest options.
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.                               10. TRTY
  594.  
  595.      In  case  the  HELP file has not accompanied the program and DOC file,
  596.   here are the items usually contained in a HELP file. The HELP fname must
  597.   be TRTY.HLP, to be lallable my TRTY.EXE.
  598.  
  599.   KEY         Function
  600.   ----------  --------------------------------------------------------------
  601.   F1          Activate function menus.
  602.   F2          Toggle from pretype to dialog and vice versa.
  603.   F3          Toggle alternate port setup.
  604.   F4          Create new configuration file configuration menus.
  605.   F5          Force disk write and start new log file.
  606.   F6          Place a control key in text.
  607.   F7          Force Relay recording to start. (Clears Pretype buffer.)
  608.   F8          Zoom/UnZoom Window with cursor.
  609.   F9          Select Session 1.
  610.   F10         Select Session 2.
  611.   S-F1        Help screen.
  612.   S-F2        Configure screen.
  613.   S-F3        Disk I/O menu.
  614.   S-F4        Window management menu.
  615.   S-F5        Miscellaneous options menu.
  616.   S-F6        Port Setup menu.      
  617.   S-F7        File usage display menu.
  618.   S-F8        Change constants menu.
  619.   Ctrl-a      Select (A-P) string and place at end of text.
  620.   Ctrl-b      Mark first or last line of block. (one block at a time.)
  621.   Ctrl-c      Two times in succession causes program to terminate.
  622.   Ctrl-d      Delete the block marked by Ctrl-b.
  623.   Ctrl-e      Erase active window.
  624.   Ctrl-f      Re-send last transmission or Force Relay to play.
  625.   Ctrl-g      Mark end of text with NNNN and Ctrl-v.
  626.   Ctrl-h      Back space.
  627.   Ctrl-i      Tab.
  628.   Ctrl-j      Line feed.  Also causes line to be inserted when editing.
  629.   Ctrl-l      New line with fancy margin.
  630.   Ctrl-m      Carriage return.
  631.   Ctrl-o      Toggle Port On/Off.
  632.   Ctrl-t      Place time and date at cursor.
  633.   Ctrl-u      Unmark the marked block.
  634.   Ctrl-v      Set end of text in the text. Transmission ends at the mark.
  635.   Ctrl-w      Play WRU message.
  636.   Ctrl-x      Toggle transmission on and off.
  637.   Ctrl-y      Move marked block and insert following line cursor is on. 
  638.   Ctrl-z      Copy block and insert following the line cursor is on.
  639.   Ctrl-\      Place Bell in text.  (Ctrl-reverse slash)
  640.   Home        Beginning of line.  Top of window.  Top of file.
  641.   Cursor keys.  Up,down,left,right as marked.  (May also force scrolling)        
  642.   Esc         Two times in succession causes program to terminate.
  643.  
  644. The following keys are unique to the IBM PC.
  645.  
  646.   Ins           Toggles insert mode.
  647.   Del           Deletes a character.
  648.   PgUp          Scrolls window up one page.
  649.   PgDn          Scrolls window down one page.
  650.   End           End of line.  End of screen.  End of file.
  651.   Ctrl-Bksp     Deletes a line.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.                                  11. TRTY
  659.  
  660. The following keys are unique to the Z100.
  661.  
  662.   Ichr          Toggles insert mode.
  663.   Shift-Ichr    Deletes a character.
  664.   InsLine       Insert a line.  (Same as Ctrl-j.)
  665.   DelLine       Deletes a line.
  666.   F0            End of line.  End of screen.  End of file.
  667.   F11           Scrolls window up one page.
  668.   F12           Scrolls window down one page.
  669.   Help          Help.
  670.  
  671.   CONFIGURATION OF SPECIFIC ITEMS:-
  672.  
  673.   PROGRAMMABLE LINES:-
  674.  
  675.      This  program  allows  16  callable STRINGS to be programmed, for each
  676.   SESSION, and to  be  called  with  the  CTRL-A  control.  The  number  of
  677.   characters,  including  the string name may not exceed 80 characters. Use
  678.   your normal ASCII editor or edit the configuration record  directly  from
  679.   within the TRTY program. See the MASTER.DOC for examples and placement of
  680.   the  strings. Format control of the STRINGS is possible by the use of the
  681.   following control sequences if contained within the quoted  part  of  the
  682.   string.
  683.  
  684.       "\M(or m)" means Insert CR here.
  685.       "\J(or j)" means Insert LF here.
  686.       "\N(or n)" means Insert NNNN and CTRL-V here. Normal end of xmission.
  687.       "\Sx"      means Play STRING(x) here. Only four "Plays" in a row.   
  688.       "\\"       means Send ESCAPE character.
  689.       "\L"       means Insert Fancy Margin.
  690.  
  691.      These   control  sequences  are  intended  to  reduce  the  number  of
  692.   keystrokes needed in normal RTTY communications, and for Macro  sequences
  693.   in Packet and Amtor communications. Experiment with these controls.
  694.  
  695.   REMOTE CONTROL:-
  696.  
  697.      This  version of TRTY will respond to the following incoming commands,
  698.   if preceded by a CR and a LF, and  the  Pre-type  buffer  of  the  called
  699.   station, is clear or empty.
  700.  
  701.         callsignZC - Set RELAY to copy incoming
  702.         callsignZR - Relay message, with VIA etc.
  703.         callsignZP - Replay previous transmission, WRU if pretype empty.
  704.         callsignZW - Play WRU
  705.         callsignZLcallsign - Inquire remote station status. (see below)
  706.         callsignZMcallsign - Relay station call to Remote. (see below).        
  707.         :TIME - Play all WRU'S
  708.         :DISK - Play all WRU'S if in DISK COPY
  709.         :xTIME - Play x call area WRU's (use 0 to 9 for x)
  710.         :xDISK - Play x call area WRU's (use 0 to 9 for x)
  711.  
  712.   REMOTE WRU FUNCTION:-
  713.  
  714.      To  determine if a remote station is active, when you can not hear the
  715.   station on a direct path, the  REMOTE  WRU  function  is  available.  The
  716.   function will only work when a version of the RTY.EXE or TRTY.EXE program
  717.   is in use at all stations involved. By the use of specific "Z" signals, a
  718.   remote,  but unheard station, can be triggered to send its WRU, through a
  719.   relay station, and thus be heard by the originating station.
  720.  
  721.  
  722.                               12. TRTY
  723.  
  724.         Following is the procedure to activate this feature:
  725.  
  726.         ------------        -----------          -----------
  727.         : Original :        : Relay   :          : Remote  :
  728.         : Station  :----\---: Station :-----\----: STATION :
  729.         :          :        :         :          :         :
  730.         ------------        -----------          -----------
  731.  
  732.     Callsigns:
  733.            aaaaa              bbbbb                ccccc
  734.  
  735.     Action:                             Comments:
  736.  
  737.     aaaaa Sends:                        Calling station
  738.     bbbbbZLccccc<ret>                   Request bbbbb to call ccccc's WRU
  739.     NNNN                                Hit CTRL-G, for NNNN's
  740.     -
  741.     bbbbb Automatically Sends:          Response from bbbbb
  742.     cccccZMbbbbb                        Ask ccccc to relay WRU to bbbbb
  743.     NNNN                                Normal 4 N's
  744.     -
  745.     ccccc Automatically Sends:          Response from ccccc
  746.     bbbbbZC                             Set relay at bbbbb
  747.     WRU for ccccc                       Normal WRU from ccccc
  748.     bbbbbZR                             Request bbbbb relay
  749.     -
  750.     bbbbb then relays the WRU of ccccc, for all to hear.
  751.     -
  752.      No operator intervention is required at any station, other than at the
  753.   originating  station.  The remote stations must have RELAY mode "ON", and
  754.   each Pre-type buffer empty.
  755.  
  756.                             -:EDITING TEXT:- 
  757.  
  758.      Text  can be edited, deleted and/or moved from any window to any other
  759.   window. Move the cursor to the window with the  data  to  be  edited,  by
  760.   hitting  F9  of  F10, for the SESSION, and F2 to toggle the cursor in the
  761.   windows. Note the Control keys, Ctrl-B, Ctrl-Y, Ctrl-Z etc. Hit Ctrl-B at
  762.   the start and finish of a block to be moved, move the cursor to the place
  763.   in the window to receive the text, and hit either Ctrl-Y  or  Ctrl-Z  and
  764.   the  data will be moved. (see HELP file for control key action) Note that
  765.   the blocked data, is highlighted in the color configured  as  'HIGH_LITER
  766.   n" for that window, in the configuration file.
  767.  
  768.                          -:SYSTEM REQUIREMENTS:-
  769.  
  770.      This  version of TRTY requires 300k or more of RAM, and version 2.0 or
  771.   higher of PC-DOS or MSDOS. The FILES parameter  in  the  CONFIG.SYS  file
  772.   should  be  reviewed.  This  program can use as many as four files at one
  773.   time. FILES=20, BUFFERS=20 are suggested. Some versions of MSDOS and some
  774.   IBM system copies may give trouble, not all combinations and systems have
  775.   or can be tested. 
  776.  
  777.      The  program  will  start  in  a default mode, or in the configuration
  778.   called in the TRTY.CFG record. Other configuration files may be called on
  779.   the command line. I.E., TRTY ZEN MYCONFIG.CFG <cr>.
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                                 13. TRTY
  789.  
  790.                            -:PACKET OPERATION:-
  791.  
  792.      Four handshaking modes are available. None, DTR/DSR, RTS/CTS and soft-
  793.   ware XON/XOFF. An 'x' will be shown, just before the TIME display, on the
  794.   24th  line,  when an XOFF has been received. Normally this will be reset,
  795.   as the XON is received from the external unit. The 'x' can  be  reset  by
  796.   hitting F6 and then letter 'Q', if the system hangs up with no XON. 
  797.  
  798.      Data may be held in the Pretype buffer, while using FullDUplex, until
  799.   ready to send it, by hitting CTRL-X, turning Off the FullDuplex, and then
  800.   send it, by again hitting CTRL-X. 
  801.  
  802.      The TRTY program has been tested on packet nets, with the TNC-1, TNC-2
  803.   and  with  the Kantronics KPC-2400. Make sure that the serial cable lines
  804.   connect the proper inputs  and  outputs,  especially  if  using  hardware
  805.   handshaking. The use of DTE and DCE serial port configurations, can cause
  806.   some  connection  problems.  I  have found that with the ZENITH Z100, the
  807.   following cable changes are necessary to get DTR/DSR hardware handshaking
  808.   to work with the Kantronics KPC-2400..
  809.  
  810.   J1 RS-232 ports.         J2 RS-232 ports.
  811.   Z100   TNC               Z100   TNC
  812.   PIN    PIN               PIN    PIN 
  813.   2      3                 2      2 
  814.   3      2                 3      3
  815.   20     5                 6      5
  816.   6      4                 20     4
  817.   8      -                 8      -
  818.  
  819.      There appear to be some differences between some TNC and KANTRONIC
  820.   models, so be aware that the problem exits. No cable changes have been
  821.   necessary for any IBM type systems, but not all have been tested, so
  822.   watch the copycat systems.
  823.  
  824.                       -:ANSWERS TO QUESTIONS:-
  825.  
  826.   Source code will NOT be made available.
  827.  
  828.      Buffer  space  will  always be available, for any need. If the buffers
  829.   all get filled, then the buffers will FIFO, and the oldest data  will  be
  830.   lost.  The  available  buffers  are divided, by the program, half to each
  831.   SESSION. Clear the buffers, when no longer needed, by hitting CTRL-E.
  832.   
  833.      The  program  is  written in Turbo C, and has taken about two years to
  834.   reach this level of performance. It was written by one  very  experienced
  835.   programmed and a great group of 'DEBUGGERS", and 'BETA TESTERS'. The TRTY
  836.   program  is  based on an older program, written by the same group, called
  837.   RTY.COM. RTY was available for the HeathKit H89 in both CPM and HDOS, for
  838.   the ZENITH Z100 series in MS-DOS, and for the IBM  systems in  PC-DOS.  I
  839.   still have the RTY program available.
  840.  
  841.      I  hope that with this doc file, and some time, that all can configure
  842.   the TRTY program, and enjoy it as much as have the HeathKit Amateur Radio
  843.   net members. So, have fun, enjoy...
  844.  
  845.   END OF FILE:---
  846.  
  847.